home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / AMICUS / AMICUS26.ADF / Tartan / Tartan.DOC < prev    next >
Text File  |  1989-01-26  |  8KB  |  180 lines
  1.                     TARTAN Program Documentation         Sept. 28, 1987
  2.  
  3.         Dick Taylor   99 Valley View Rd, Glastonbury, Conn 06033
  4. PURPOSE
  5.  
  6. TARTAN is an AmigaBasic program.  It is a design tool which enables the
  7. user very easily to create original Scotch plaid ("tartan") patterns.  Many
  8. traditional tartan patterns can also be easily reproduced.  You'll need
  9. 512K or more of RAM in order to run TARTAN.
  10.  
  11. HOW TO USE
  12.  
  13. The program begins with display of the TARTAN CONTROL panel.  At the top of
  14. this panel the COLOR MENU of 16 colors is displayed.  These are labeled
  15. 0-15. The user creates the tartan pattern by specifying pairs of numbers.
  16. Use 2 or more pairs.  The first number of the pair tells the width of this
  17. band of color:  for example 5, meaning 5 lines wide.  Typical line width
  18. values range from 2-12. The second number of the pair tells the color
  19. choice for this band:  may use any value 0-15. Let's call each pair of
  20. values an "item".
  21.  
  22. EXAMPLE #1
  23.  
  24. Let's generate a simple, well-known tartan to illustrate how this works.
  25. On the fresh control screen, the first item number (1) appears in a box,
  26. followed by a highlighted input area for "Lines". Just press key 8, and
  27. then RETURN.  Now the "Color" input area is highlighted.  Press key 2 and
  28. then RETURN.  In this first item we have just asked for a black band (color
  29. 2) of 8 lines width.  After this second return, the second item number (2)
  30. appears in a box, with "Lines" input highlighted.  Now press key 8, RETURN,
  31. then key 4, RETURN.  This second item specifies a red band of 8 lines
  32. width.  This ends our input for this tartan pattern.  Pretty simple so far?
  33.  
  34. After the last RETURN, item #3 pops up, but we won't use it this time.
  35. Just press RETURN again, telling the program that item input has ended.
  36. Now a row of buttons appears toward the bottom of the panel.  Use the Mouse
  37. to move the pointer to the left-most button labeled "DISPLAY", and click
  38. the left mouse button once.  The Control panel disappears, a basic "square"
  39. of the tartan pattern is drawn in the upper left screen corner (about 12
  40. secs) and then the screen is filled with a bold black and red checkerboard
  41. pattern.  This familiar tartan is named "Rob Roy", for a famous (or
  42. notorious by some accounts) member of the MacGregor clan of the Scottish
  43. highlands, in the early 1700's.  Notice that the squares of intersecting
  44. black and red threads contain prominent diagonal lines, alternating black
  45. and red.  This illustrates the effect produced by the "twill" weaving
  46. method of the Scottish weavers.
  47.  
  48. From the Display panel (but not from Control) a short Project Menu is
  49. available.  Use the right Mouse button to display the choices "Control" and
  50. "Quit". Select Control to return to that panel with our first tartan input
  51. still displayed.  This input may be altered, but let's see another option
  52. first.  Move the Mouse pointer to the second screen button labeled "NEW"
  53. and click the left Mouse button.  The program re-creates the Control panel
  54. ready to start with fresh input.
  55.  
  56. EXAMPLE #2     Enter 4 pairs of values (4 items).
  57.                        Lines   Color
  58.                   1.    1       11        Press RETURN after
  59.                   2.    8       2         entering each value for
  60.                   3.    8       4         Lines and Color.
  61.                   4.    1       2
  62.  
  63. When Item #5 appears, press RETURN again, then click the DISPLAY button.
  64. We see the black and red checkerboard again, but now the black squares have
  65. yellow lines through them and the red squares have black lines through
  66. them.  This is the traditional tartan of the Wallace clan.
  67.  
  68. EDIT OF INPUT DATA
  69.  
  70. Return to the control panel with Wallace input displayed.  Next to DISPLAY
  71. and NEW, notice 3 more screen buttons enclosed in a box and labeled "EDIT".
  72. These are:
  73.  
  74.  
  75.     CHANGE -- Any of the displayed line and/or color values can be changed.
  76.  
  77.     DELETE -- Any item (pair of values) can be deleted.
  78.  
  79.     INSERT -- Can add a new item at any chosen point (beginning, end, or
  80.               between other items).
  81.  
  82. HOW TO CHANGE
  83.  
  84. Let's change the yellow stripe (item #1) to a green stripe.  Use the mouse
  85. pointer to click the CHANGE button.  Notice the color reversed CHANGE label
  86. to show that is active.  Now use the Mouse pointer to click the box for
  87. item #1. The Lines value (1) is highlighted; no change to this, so just
  88. press RETURN.  Now the color value (11) is highlighted.  First, press
  89. BACKSPACE twice to remove 11, then enter 8 (for green) and press RETURN.
  90. At this point the CHANGE label is restored to normal color, and more
  91. Changes (or Deletes or Inserts) could be done.  For now, just click in
  92. DISPLAY to show the changed design color.
  93.  
  94. HOW TO DELETE
  95.  
  96. Let's try eliminating that black line through the red squares.  Back on the
  97. Control panel, click on the DELETE button, note reversed label color.  Then
  98. click in the box for item #4, which goes away, and label color back to
  99. normal.  Display as usual.
  100.  
  101. HOW TO INSERT
  102.  
  103. Let's put back a wider white stripe through the red squares.  Back on
  104. Control, click on the INSERT button, note color reversal, then click on the
  105. box for item #3. Always click the button just BEFORE the point of insertion
  106. (that's why we have a box #0). Item #4 pops up; enter values 2 and 1 (lines
  107. & color respectively) and display.  Are you getting the hang of it?
  108.  
  109.  When inserting an item which is not last, the items following the clicked
  110. item are moved up by one, and an empty item ready for input appears.
  111.  
  112. TYPING MISTAKES
  113.  
  114. On typing input, if you make a mistake and haven't pressed RETURN yet, you
  115. can always BACKSPACE and correct.  If you press RETURN and then find the
  116. mistake, just finish the rest of the input, then use CHANGE to fix the
  117. mistake.
  118.  
  119. BACKGROUND
  120.  
  121. First, some weaving terminology:  On a weaver's loom, the "warp" threads
  122. run front to back (y axis on the screen), and "weft" threads (or "woof")
  123. run side to side (x axis on screen).
  124.  
  125. On the Wallace tartan, if you compared your 4 input items with the
  126. displayed pattern, you may have noticed that your input doesn't really
  127. spell out the full design pattern.  Something has been added!  What happens
  128. is this:  Your input is doubled to make a total of 8 items, but items 5-8
  129. are the same as 1-4 in reverse order (also called mirror image). The
  130. program handles this step automatically.  Then this set of instructions (or
  131. "sett" in traditional Scottish weaving terminology) is applied to both warp
  132. and weft.  It may be of interest to note that there are a few of the
  133. traditional tartans which do not have this bi-directional symmetry.  These
  134. cannot be reproduced with the present TARTAN program.  Another program
  135. limitation:  This program can process a maximum of 20 items for one tartan.
  136. This is not a serious limitation, since most traditional tartans can be
  137. specified with 5-15 items.
  138.  
  139. Please be aware that input specifying a large total of lines can run into
  140. a RAM limitation situation.  On a 512K machine, I have found that a total
  141. lines greater than 52 causes the Out of Memory error when attempting to
  142. fill the screen from the basic "square". So for total lines greater than
  143. 52, the program just draws the basic "square", no screen fill.  Of course,
  144. this is quite a large square, about 1/2 the screen width.
  145.  
  146. FAMOUS TARTANS
  147.  
  148. Many tartans fall into 2 broad groups:  1) Bright colors, lots of scarlet,
  149. used for dress and ceremonial occasions. 2) Somber colors, very dark green,
  150. blue, black, used for hunting or everyday wear.
  151.  
  152.     Royal Stewart -- one of the bright tartans, also widely popular today
  153.                      This is the tartan of Britain's royal family.
  154.  
  155.           1.  1  1      4.  4  4      7.  2  2      10.  3  0
  156.           2.  3  4      5.  6  10     8.  2  11     11.  14 4
  157.           3.  2  2      6.  2  1      9.  4  2
  158.  
  159.     Hunting MacLean -- one of the "working" tartans.
  160.  
  161.           1.  2  10     4.  4  2      7.  16 10
  162.           2.  4  2      5.  3  10     8.  2  2
  163.           3.  2  1      6.  3  2
  164.  
  165.     Culloden -- Bonnie Prince Charlie led the Scotch clans in the final
  166. uprising in 1745, culminating in his defeat by the English on Culloden
  167. moor.  This tartan was worn at that battle.
  168.  
  169.           1.  2  4      4.  2  1      7.  2  2
  170.           2.  2  10     5.  12 2      8.  2  11
  171.           3.  12 13     6.  12 11
  172.  
  173.  Many more traditional tartans could be listed, but the real fun is in
  174. designing your own, so go to it!
  175.  
  176. REFERENCES
  177.  
  178.  1. Grimble "Scottish Clans & Tartans", Publ. Hamlyn 1973
  179.  2. Hesketh "Tartans", Publ. Octopus 1972
  180.